home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Tools&Utilities / disk-charmer-241 / Disk Charmer docs < prev    next >
Text File  |  1995-07-22  |  18KB  |  121 lines

  1. Fabrizio Oddone
  2. C.so Monte Cucco 59/F
  3. 10141 Torino
  4. Italy
  5.  
  6. Disk Charmer™ documentation
  7.  
  8. This document has styles in it. You may view them with a text editor such as Tex-Edit by Tom Bender or Style (1.2.1 or later) by Marco Piovanelli, or Apple SimpleText by Tom Dowdy.
  9.  
  10. •    SHAREWARE - US$10
  11. ◊    This program is distributed as Shareware: if you use it, you should pay the author. You may register:
  12. - with the bundled Register application, or
  13. - directly to me by sending cash (US$ or an equivalent sum with your local currency) or an international (postal) money order; if you would rather pay using a different method, try the Register application.
  14. ◊    NOTE: Getting a note, a postcard or anything else is a lot better than getting nothing. I would like to know how far this program has gone, so remember that you can do something nice even if you do not have a couple of $ to spare.
  15. ◊    The new Disk Charmer 2.x costs $10; the old Disk Charmer 1.x has been lowered to $10. You can register both versions with $20. If you are one of the (few) registered users of Disk Charmer 1.x who paid $20, you are automatically registered to Disk Charmer 2.x.
  16.  
  17. •    GENERAL INFO
  18. ◊    I will not explain the obvious here, as Disk Charmer provides Balloon Help™, and you really don’t like manuals, do you?
  19. ◊    Disk Charmer sports background formatting, currently when the Thread Manager is present. Thread Manager 2.0.1 or later is incorporated inside System 7.5.
  20. Several users reported unexpected freezes while using Disk Charmer versions earlier than 2.2. The problem resides in the Thread Manager 2.0.1 (as well as in System 7.5). The Apple engineers who work on the Thread Manager acknowledged the bug: it should be fixed installing Thread Manager 2.1 or System 7.5 Update 1.0. In the meantime I implemented a workaround: when the Thread Manager bug occurs, no more freezes; instead, the disk will erase or verify, but you will not be able to switch applications as you might want.
  21. Apple/Connectix Mode32 1.2 is incompatible with Thread Manager. Use Mode32 7.5 or later, freely available on most online services, such as the Info-Mac archive and its mirrors:
  22.  
  23. …/cfg/mode32-75.hqx; 152K
  24.  
  25. Furthermore, do not try ejecting the disk with the Command-shift-number combination while Disk Charmer initializes or verifies the disk and the Thread Manager is installed: the Operating System hangs (not my fault).
  26. ◊    Disk Charmer lets you choose whether to look for (and lock out) the bad sectors or not. Furthermore, when the message “now creating disk catalog and looking for bad sectors” appears, your Mac is no more tied up till this phase has finished as in Disk Charmer 2.0.x. This phase is actually made of two parts: the first part can execute concurrently with other applications, the second part (which starts only if the disk is bad) unfortunately cannot. This is Apple’s fault (again…); it happens (sorry, this is technical jargon) that the _DIZero system routine may move memory, so it cannot be called at interrupt time, while the initializing and verifying routines may be called in a safe way.
  27. I managed to add this feature in 2.1 with a clever hack; however, this hack does not break any of Apple’s guidelines, so it should be safe.
  28. ◊    You can launch Disk Charmer multiple times in a networking environment, as well as from a locked disk (CD-ROMs are welcome; by the way, if this application is included on a CD it would be nice to send me a complimentary copy of it).
  29. ◊    Disk Charmer is intelligent enough to use temporary memory when it needs to read in a disk, so you do not have to get mad setting its memory partition.
  30. ◊    Disk Charmer 2.x can only be used under System 7 or later; if you try to start it up under older versions of the System you will get an error message. (Sorry, Ingemar! :-) )
  31. ◊    You should notice that Disk Charmer allows switching among applications while operating. This happens because I use “asynchronous” reads and writes from/to the disks. Macs with I/O chips (IIfx, Quadra 800, 900, 950, the Workgroup Servers, the AVs and the PowerMacs) do not slow down while reading the entire disk.
  32. Several users noted that during the initializing process the cursor movement was jerky, and suggested to give up the processor to allow smoother cursor control. The cursor movement is “interrupt-driven”: it does not depend on the processor sharing among applications. It happens that the Disk Driver disables interrupts frequently and for long periods while interacting with the disks. While interrupts are disabled, the processor cannot acknowledge that the cursor has been moved and react accordingly. Again, the Macs with I/O chips do not exhibit this problem, because cursor movement and disk access are handled by separate custom processors, offloading the central one. Unfortunately, even Macs with Sound Chips cannot play sounds smoothly while a disk is being formatted/verified (perhaps the AV can?).
  33. ◊    I wrote Disk Charmer because a friend of mine gave me a tape drive as a present. I put my enormous floppy collection on tapes, then I needed to re-format all of the darned floppies! I was really tired of the modal interface of Disk Charmer 1.x. I wanted a drag & drop eraser with every possible option and a nice, easy to use interface. If you think I have succeeded, send me the fee!
  34. You certainly noticed that Disk Charmer 2 is a direct consequence of a “hardware” gift. So, if you really feel compelled, send in good hardware! Perhaps I will be inspired and write another piece of useful software ;-).
  35. ◊    Disk Charmer now supports 720K and 400K disks.
  36. Tip: to make a 400K HFS disk, hold down the option key when the catalog is being created. Otherwise, you obtain an old-style MFS disk. MFS, the file system used on the original Macs, is not fully supported under System 7. This tip does not apply to the newest System versions: HFS is always used.
  37.  
  38. •    DISCLAIMER
  39. ◊    “No warranties at all, either express or implied…” “All trademarks are held by their respective owners…” and all that stuff.
  40. This application should do no damage, but if it does then you will be on your own. Let me know of any bugs you run into, anyway.
  41.  
  42. •    VERSION HISTORY:
  43. ◊    2.4.1 - Fixed the bug that prevented proper behavior without the Extended Disk Initialization Manager installed.
  44. ◊    2.4 - Supports non-Mac file systems, and InternetConfig. Accepts drag&drop from the System 7.5 Find File window. Slightly reorganized the prefs. Other minor fixes.
  45. ◊    2.3.1 - Moved the eject option to the main window; better handling of the Edit menu when a movable modal dialog box is visible; grays the Act on disk insertion menu item when attempting to restore a disk.
  46. ◊    2.3 - Movable modal dialog boxes everywhere. Additional Act on disk insertion and Auto Quit options. Various code tweaks and fixes.
  47. ◊    2.2.3 - Eject option moved to the menus; no more ejects disks on startup (I found it mostly annoying).
  48. ◊    2.2.2 - Uses the Apple MoreFiles library. E-mail address update. Minor changes.
  49. ◊    2.2.1 - Zoom rectangles; eject disks option more flexible, can operate via menus (Alessandro Levi Montalcini insisted a little bit on these).
  50. ◊    2.2 - Drag Manager support. Worked around a bug in the Thread Manager 2.0.1. Fixed a subtle bug that could affect the Lock out bad sectors option. For the technically inclined, I forgot to set the ioResult field in the _Control temporary patch (I was only setting the D0 register). The bug surfaced out when installing the Apple File System Manager extension. Minor fixes; updated the docs.
  51. ◊    2.1.4 - Ejects the disk if it does not mount when you hold down the option key (Alessandro Levi Montalcini’s suggestion); updated the docs.
  52. ◊    2.1.3 - Little fix in the registration code.
  53. ◊    2.1.2 - Additional disk eject option, inspired by Alessandro Levi Montalcini. Warns when the Thread Manager is installed or un-installed. Does not try to eject the disk if there are open applications/documents on it (again, thanks to Peppino). Little fix for virtual memory - I am not sure whether it was necessary, but you know: the safer, the better.
  54. Forgot to include Luca Broglio in the credits. Luca helped with his PowerBook 160 in fixing the bug eliminated in 2.1.1.
  55. ◊    2.1.1 - A wonderful and subtle bug lurked in the code I wrote to allow the marvelous additions in 2.1. This could cause subtle hangs while Disk Charmer was creating the disk catalog.  Incredibly indeed, last night I had a nightmare in which I discovered a bug in Disk Charmer 2.1. Well, this was a premonitory dream, really.
  56. ◊    2.1 - Lets you choose whether to lock out bad sectors or not. The first part of the bad sectors search phase can now execute concurrently with other applications, provided that you have the Thread Manager installed.
  57. ◊    2.0.8 - Alerts if you try using a floppy disk with open applications/documents on it.
  58. Fixed (at last!) a problem with the about box, and its incompatibility with AutoMenus II, reported by Duane W. Small and stevewho@aol.com. It was my fault, not AutoMenus’.
  59. No more pauses between initializing and verifying (this only occurred on some Mac models and when the Thread Manager was not installed).
  60. Slightly increased the memory partition.
  61. The Command-period key combination is detected in the Apple-approved way; the previous method I adopted, although pretty straightforward, does not work (according to Apple) on some international keyboards.
  62. You can abort by pressing esc or Command-period immediately after the disk is inserted.
  63. If you insert (when trying to undo) a disk which has not the correct capacity, Disk Charmer suggests the right capacity.
  64. Added a nifty registration form.
  65. ◊    2.0.7 - Erasing a disk with the “Rename already formatted disks” option unchecked led to a bus or address error (found by Peppino the everpresent); stripped down a bit of code.
  66. ◊    2.0.6 - Bug fix introducing a new bug: ever heard of this? It happens that the Disk Driver needs 2 instead of 0 in csParam only for 800K disks; HD disks need 0.
  67. ◊    2.0.5 - Will not bore when you insert a High Sierra, ISO 9660 or Audio CD-ROM telling you that the disk is locked: the CD now mounts on the desktop (if the CD-ROM driver is installed, obviously); the message informing that a bad disk was ejected did not state that the disk was actually repaired (reported by Alan Harris); when the “Erase disk” option is active and you insert a disk formatted with a smaller than the maximum capacity, the capacity is now correctly set to the maximum (reported by Fabrizio Grandoni and Martin Josso) (for techies: set the csParam in the _Control call to 2 instead of 0, a nice but undocumented feature of the Disk Driver); keeps the undo buffer correctly instead of discarding it in one particular event; slightly increased the memory partition.
  68. ◊    2.0.4 - Tremendous error: start up Disk Charmer 2.0.3 with System 6 and get the following: there is not enough memory…! Now the message is correct (reported by Roberto Leonardi of MacDisk Magazine).
  69. ◊    2.0.3 - In unusual circumstances the icon in the Disk Charmer window would not gray out (tech note: it seems that you cannot mask out osEvents); alerts if the user types a disk name longer than 27 characters; minor improvements; better dialog design for disk naming, suggested by Alessandro.
  70. ◊    2.0.2 - The icon in the Disk Charmer window appears grayed when DC is in the background; warns you if the disk is “not a Macintosh” one, such as a WC-DOS disk; interface oddities removed: gone are the useless icons in the main window; fixed an obscure bug, occurring because I did not set correctly a couple of resource attributes (I am particularly ashamed for this); now it is faster when operating in background with the Thread Manager installed and other applications tying up the processor; did not update and activate correctly the main window when the preferences dialog was open (Peppino strikes back); did not clear the disk name in the main window when a blank disk was inserted (Return of the PeppinJedi); minor internal improvements.
  71. ◊    2.0.1 - The disk names are properly truncated: you cannot give a name longer than 27 characters to a disk (Peppino reminded me of this). The Macintosh Clipboard is copied (in memory) across every opened application. If the clipboard is large, Disk Charmer 2.0 sometimes tells you that there is not enough memory to run. This was fixed (reported by Alessandro).
  72. ◊    2.0 - Released!
  73. ◊    2.0b6 - Balloon help tells that verifying is non-destructive, and indicates precise Kbyte gains when you make larger disks; minor code changes; icon placement modified & changes in the application small icons suggested by Alberto Ricci.
  74. ◊    2.0b5 - Now the user can disable the use of the Thread Manager in the preferences; it tells you whether it will read the next disk or not if the previous disk was bad (bug found by Peppino). 
  75. ◊    2.0b4 - Uses the Thread Manager if present, so that background formatting is possible; sets the cursor to a watch when necessary.
  76. ◊    2.0b3 - Redraws the text drawn after erasure one time only.
  77. ◊    2.0b2 - Fixed a quirk in the dialog handling code; clicking on the disk icon iconizes and de-iconizes the window (implemented because most people do not seem to notice the zoom box); redraws the text drawn after verification one time only; leaves the disk name shown after ejection; gives a verbose error if you cleverly insert a locked, unreadable disk.
  78. ◊    2.0b1 - Redraws the text one time only if you press esc or Command-period repeatedly while reading (thanks, Paolo!) and beeps when the key is hit for feedback; instead of the generic “waiting…” message, it tells you whether it will read the next disk or not (suggested by Peppino); filtered characters, so that only numbers are accepted, in the preferences dialog.
  79. ◊    2.0a10 - Lowered memory requirements.
  80. ◊    2.0a9 - Stripped out a bit of code; handled async reads & writes with completion routines.
  81. ◊    2.0a8 - Added asynchronous disk ejection; it does not seem to be different from the synchronous one.
  82. ◊    2.0a7 - Added accent on António (Costa), remarked by Federico Cavaglià; changed the About… picture; added a couple of balloons; the disk name did not appear when verifying only (thanks, Peppino!).
  83. ◊    2.0a6 - Checks if there is enough memory to run; split preferences, with more naming features; improved Balloon Help; improved (but it is still ugly) the “larger disks” signal.
  84. ◊    2.0a5 - Set resource attributes better; added “larger disks” signal in the main window.
  85. ◊    2.0a4 - One alert was not sufficiently tall to accommodate for the text.
  86. ◊    2.0a3 - Cool about box… not for everybody! Added verbose explanations for the most common errors and better handling of uncommon disk formats.
  87. ◊    2.0a2 - Added support for esc & Command-period in alert boxes. Various minor corrections and bug fixes.
  88. ◊    2.0a1 - I have not recorded the nine development versions, so I start here.
  89.  
  90. •    THANKS TO…
  91. ◊  Eric Anderson at Apple, who was very patient and helpful when he had to listen to my bug reports.
  92. ◊  Luciano Baesso, whose wide range of Macs allowed more extended testing.
  93. ◊  Luca Broglio, whose PowerBook 160 crashed, allowing to fix the bug in version 2.1. He patiently let me Macsbug-ize Disk Charmer on his Mac for a whole morning.
  94. ◊  Federico Cavaglià, for patient and impatient beta-testing and a long list of things, too long to be summarized here (he rightfully calls me “the sloppy programmer”). Furthermore, Disk Charmer 2.x exists only because of his gift.
  95. ◊  Edoardo Ciotti tested on his lowly Mac SE.
  96. ◊  Derek Currie, Jost Jourdan, Horst Prillinger, Shimpei Yamashita reported the bug which happened to be in Thread Manager.
  97. ◊  Eric Garneau, who woke the MacUser USA people up from letargy with a letter recommending Disk Charmer in the Nov. 1994 issue.
  98. ◊  Stephen Jonke, who suggested the new options in 2.3.
  99. ◊  Roberto Leonardi found the awful bug of the wrong alert, and last but not least distributed Disk Charmer on MacDisk Magazine here in Italy.
  100. ◊  Alessandro Levi Montalcini, who gave many, many fundamental suggestions about the user interface. Disk Charmer 2.x would have been really worse without his help.
  101. ◊  Jim Luther for helping, and his great MoreFiles library.
  102. ◊  Naoari Miyaishi, Koya Matsuo and the folks at MacUser Japan, who included Disk Charmer on the MacUser Japan CD and kindly sent me a copy of the issue.
  103. ◊  Masatsugu Nagata, who helped a lot with beta testing and will advertise Disk Charmer on Info-Mac now that there is his name on it :-)
  104. ◊  Anna Olmo tested on her Color Classic.
  105. ◊  Ingemar Ragnemalm had the good idea of naming new disks differently depending on whether bad sectors are found or not.
  106. ◊  Giovanni Rava lent me a couple of useful (read: full of documentation) CDs.
  107. ◊  Alberto Ricci, for aesthetical suggestions regarding my icons, and beta testing.
  108. ◊  Mirko Richiero gave useful suggestions, too.
  109. ◊  Alessandro Rodella suggested the technique that led me towards the “Thread Manager bug” hypothesis. That technique also served as a workaround.
  110. ◊  Paolo Sasso tested on his PowerBook 180, discovering that Greg’s Buttons 3.0 freezes his Mac while Disk Charmer is reading from the disk.
  111. ◊  Felix Thomann reviewed Disk Charmer on the Mac Users Switzerland magazine and kindly sent me a copy of the issue.
  112. ◊  Giuseppe “Peppino” Ventura discovered the interesting (unintentional) feature allowing to make 720K Mac disks, suggested the extended disk naming options (normal vs. larger) and tested on his lowly Mac Classic, finding lots of bugs.
  113. ◊  Jonas Wallden, one of the few who exploits the Thread Manager in his programs.
  114. ◊  Don Ernesto Zucchini, who was the first ever to register Disk Charmer (1.x), back in 1990.
  115.  
  116. •    ENJOY YOURSELF,
  117. and remember that more and more shareware authors are going commercial or worse, going Windoze, because they receive almost nothing. If you don’t pay for good shareware software today, you are likely to pay much more in the future for exactly the same features, plus a nifty package, a good manual, and perhaps a copy protection scheme or a serial number; you know you don’t need the package, or the copy protection, and undoubtedly you will not want to waste your time reading manuals.
  118.  
  119. To report errors, suggestions, or whatever, send e-mail to fab@kagi.com
  120.  
  121. – Fabrizio Oddone